home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / msdos / raytrace / pov / gen / hype / hype100.doc < prev    next >
Text File  |  1992-08-11  |  7KB  |  170 lines
  1. ┌──────────────────────────────────────────────────────────────────────────────┐
  2. │ Hype v1.00                                                                   │
  3. │ Copyright (C) 1992                                                           │
  4. │ By Truman Brown                                                              │
  5. └──────────────────────────────────────────────────────────────────────────────┘
  6.  
  7. HYPE:
  8.  
  9.      HYPE is a data file generator for the Persistence of Vision Raytracer
  10.      (POV-Ray). For information about raytracing, POV-Ray, computer
  11.      generated art, or other utilities supporting the art of raytracing
  12.      please visit the Computer Art forum on CompuServe (tm) [GO COMART] or
  13.      any one of the following fine graphics oriented bulletin boards:
  14.         The Graphics Alternative 510-524-2780
  15.         You Can Call Me Ray      708-358-5611
  16.         Leo's Electronics BBS    310-212-7179
  17.  
  18. RESTRICTIONS AND DISCLAIMERS:
  19.  
  20.      HYPE is freely distributable.  The author retains the copyright to the
  21.      program, but authorizes free distribution by BBS'es, networks,
  22.      magnetic media, etc.  The distributor may charge no more than five
  23.      dollars ($5) U.S. for this software.
  24.  
  25.      HYPE may not be used as part of any commercial package without the
  26.      explicit written consent of the author - Truman Brown.  You may
  27.      contact me on CompuServe, 71477,221.
  28.  
  29.      The author makes no guarantees or warranties with this program and
  30.      claims no responsibility for any damage or loss of time caused by this
  31.      program.
  32.  
  33. DESCRIPTION:
  34.  
  35.      Hype is a command line utility which enables you to create unique
  36.      declarations of hyperboloids of one sheet and intersections of same.
  37.      What is a hyperboloid of one sheet?  It is a quadric shape that
  38.      resembles an hourglass and is defined by the equality:
  39.  
  40.      x^2/a^2 - y^2/b^2 + z^2/c^2 = 1.
  41.  
  42.      In SHAPES.INC it is declared as this matrix:
  43.         #declare Hyperboloid_Y = quadric {
  44.            <1.0 -1.0  1.0>  /*                      */
  45.            <0.0  0.0  0.0>  /*            \   /     */
  46.            <0.0  0.0  0.0>  /* Like this:  ) (      */
  47.            -1.0             /*            /   \     */
  48.         }
  49.  
  50.      A trace of a hyperboloid of one sheet in the xz-plane is an ellipse,
  51.      as are the traces in planes parallel to the xz-plane.  Traces in the
  52.      xy- and zy-planes are hyperbolas, as are the traces in the planes
  53.      parallel to these.
  54.  
  55.      While the SHAPES.INC Hyperboloid_Y can be scaled and otherwise
  56.      transformed, it is still somewhat difficult to manipulate the shape
  57.      with any measure of accuracy.  Using Hype, you will be able to create
  58.      unique declarations of hyperboloids of one sheet, and you will also be
  59.      able to specify clipping planes which will result in exact
  60.      measurements of the top and bottom of the "hourglass."  When used with
  61.      CircleMaster, Hype will also enable you to create the appearance of
  62.      pseudo-bloblike mergings between spheres.
  63.  
  64. SYNTAX:
  65.  
  66.      HYPE /R# /R# /Ofilename [options]
  67.  
  68.      /R# = radius of 1st end of clipped hyperboloid {absolute value > a}
  69.      /R# = radius of 2nd end of clipped hyperboloid {absolute value > a}
  70.      /Ofilename = name of output file to write data to
  71.  
  72.      Options:
  73.  
  74.      /Nobjectname = assign object name
  75.      /C           = use CLIPPED_BY instead of intersections
  76.      /PB          = write output in PoV beta 0.5 syntax
  77.      /A#          = default = 1
  78.      /B#          = default = B=A=1
  79.      /NS          = don't write stats to output file
  80.      /NB          = don't write bounding data
  81.      /L#          = length of cone <must be greater than 0>
  82.      /T#          = desired angle of tangent at first end of cone
  83.  
  84. NOTES:
  85.  
  86.      "/"s are optional.
  87.      Whitespace is permitted between parameters.
  88.  
  89.      /L and /T will override the /B parameter
  90.      /L and /T are mutually exclusive.  Use one or the other but not both.
  91.  
  92.      "A" is the value of the radius of the neck of the hourglass.
  93.          The neck of the hourglass is positioned at x=0, y=0, z=0.
  94.      "B" is the focus of the rotational hyperbola.
  95.      "T" is the value of the tangent angle at the clipping point.
  96.      "R" is the radius at either the top or the bottom clip.
  97.          The first "R" is the "bottom" radius.
  98.          Negative values of "R" place the clip below the neck.
  99.          Positive values of "R" place the clip above the neck.
  100.  
  101.              2nd R
  102.         ------------- T
  103.          \         /
  104.            \     /
  105.             ) A (          B
  106.            /     \
  107.          /         \
  108.         -------------
  109.             1st R
  110.  
  111.      By definition, "A" must be smaller than both "R"s.  The default value
  112.      of "A" is 1.0.
  113.      By definition, "B" must be greater than zero.  The default value of
  114.      "B" is 1.0.
  115.  
  116.      When generated, the resulting clipped hyperboloid is translated such
  117.      that the bottom clip is sitting at the origin (Y=0).
  118.  
  119. EXAMPLES:
  120.  
  121.      Create a clipped hyperboloid with a top and bottom radius of 10, and a
  122.      neck radius of 4 ("B" defaults to 1.0):
  123.         HYPE /R-10 /R10 /A4 /OTEST.INC
  124.  
  125.      Create a clipped hyperboloid with a top radius of 10 and a bottom
  126.      radius of 5, both of which are above the neck ("A" & "B" default to
  127.      1.0):
  128.         HYPE R 5 R 10 O TEST.INC
  129.  
  130.      Create a clipped hyperboloid with a top radius of 5 and a bottom
  131.      radius of 39, both of which are below the neck.  Make the tangent
  132.      angle at the top clip 35 degrees (everything else defaults):
  133.         HYPE R-39 R-5 T35 /OTEST.INC
  134.  
  135.      Trick: a hyperboloid cone --
  136.      Create a clipped hyperboloid with a top radius of 10 and a bottom
  137.      radius of 5, both above the neck.  Make the length of the clipped
  138.      hyperboloid 20:
  139.         HYPE /R 5 /R 10 OTEST.INC L 20
  140.  
  141.      Trick: pseudo-bloblike connections --
  142.      Create a pseudo-bloblike connection using CircleMaster and Hype:
  143.         1.  Create a clipped sphere of radius 10 clipped at a resulting
  144.             radius of 6:
  145.                CM X10 Y10 R6 O SPHERE.INC
  146.  
  147.         2.  Read the stats generated by CM to determine the tangent at the
  148.             intersection plane.
  149.  
  150.         3.  Feed the tangent angle into HYPE, matching the radius of the
  151.             resulting plane:
  152.                HYPE R-6 R6 A3 O HYPE.INC T36.86989764584402
  153.  
  154.         4.  Edit the include files so that the clipped hyperboloid lays on
  155.             top of the clipped sphere.
  156.  
  157.      Most HYPE's parameters are fairly self-explanatory.  As with any
  158.      utility however, it's generally best to just play around with it and
  159.      see what it's capabilities are.  I encourage you to do so with HYPE.
  160.  
  161. CREDITS:
  162.      I wish to thank:
  163.  
  164.      My wife Madrid for her patience and love.
  165.      Obsessed programmers / trace-aholics can be miserable to live with.
  166.  
  167.      The Pasadena Public Library, City of Los Angeles Library, and the
  168.      Pasadena City College Library for maintaining such excellent research
  169.      materials.
  170.